home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac: Not for Sale / Another.not.for.sale (Australia).iso / fade into you / getting there / Apps / MacWAIS 1.29 / README < prev    next >
Text File  |  1994-05-19  |  10KB  |  157 lines

  1. What does this release contain?
  2. -----------------------------
  3. This release contains 6 files and folders.
  4.  
  5. 1.  README -- this document.
  6. 2.  README.shareware -- legal/license and shareware registration information.
  7. 3.  MacWAIS -- the EINet WAIS client for the Macintosh (version 1.29).
  8. 4.  EINet Shareware -- a WAIS question that'll get you information about EINet shareware.
  9. 5.  MacWAIS User Manual -- written in MSWord.
  10. 6.  wais-sources -- folder containing WAIS Source descriptions.
  11.  
  12.  
  13. MacWAIS 1.29 Release Note 19may94
  14. ---------------------------------
  15. This is a simple, but effective update to 1.28.  Most notably I added Apple Event support for OpenURL.
  16.  
  17. (I've done away with the text-only version of the User Manual.  Let me know if this causes undue heartache.)
  18.  
  19. Changes from 1.28:
  20. * Apple Event support for OpenURL.  This allows our new World Wide Web client (MacWeb) to hand wais URLs to it.  (MacWAIS now has a default Launcher defined for WAIS type HTML -- namely, MacWeb.)
  21. * Added a popup menu to the Preferences dialog that allows the user to select the character transliteration option (i.e., which 'cmap' resource) is to be used in mapping extended characters (i.e., codes >= 128) to Macintosh characters.  (Yes, new transliteration tables can be added as 'cmap' resources (to either MacWAIS or the MacWAIS Preferences file).  The default is id = 128.)
  22. * Added a "Window At Startup" Preference that has 3 options:  None (the default), New (as it used to be), and Dialog (displays the Open Question dialog).
  23. *    Fixed a bug in SearchWais introduced as part of the "smart" MaxResDocs allocation added in 1.28.  (Thanks to David Inman (David.Inman@cdc.com) for reporting this bug.)
  24. *    Modified suGetDirectoryPath so it will present the user with the SFPut Dialog for saving
  25.     Sources that have names > 31 characters (even though the "wais-sources" Preference may be set).  (Thanks to David Inman (David.Inman@cdc.com) for his help in solving this problem.)
  26.  
  27.  
  28. MacWAIS 1.28 Release Note 23Feb94
  29. ---------------------------------
  30. A couple of versions have skipped by without my updating the shareware release
  31. for which I apologize.  Significant *new* features include:  "smart" allocation of
  32. MaxResDocs, and character translation for codes > 128 (it's about time, eh Alberto? :-).
  33.  
  34. A new version of the User Manual was *not* generated for this release.  (But I am
  35. including the Manual generated for 1.26 which is slightly different than that for
  36. 1.25.)
  37.  
  38. Special thanks go to Alberto Arabia (arabia@mathp7.jussieu.fr) for suggesting and testing the addition of extended character translation, and to Nathaniel Lee (than@wais.com) for suggesting and testing the addition of "multi-sources".
  39.  
  40. Changes from 1.27:
  41. *    Made changes to accommodate addition of Type argument to prefs-utils
  42.     functions.
  43. *    Turned "Smart Link" back on.  This may or may not cause problems.
  44. *    Modified allocation of MaxResDocs so it's "smarter".  Before, MaxResDocs
  45.     was evenly allocated amongst all sources.  Thus, if MaxResDocs = 40, and a
  46.     Question is directed to 2 sources, then each source will have the opportunity to
  47.     return 20 result docs.  In this example, if the 1st source only returns, say, 2
  48.     documents, then there are 18 result docs that'll go unused.  Now, remaining docs
  49.     are re-allocated amongst the remaining sources. Thus, to continue this example,
  50.     the 2nd source, instead of having 20 docs (as initially allocated) will have 38.
  51. *    Began adding "multi-sources".  (A "multi-source" is a single source file
  52.     that contains multiple source descriptions.)  They can be viewed, but they can't
  53.     be edited.  (Currently, when editing a multi-source, changes can only be made to
  54.     the head element.  A subsequent release will enable the editing of multi-sources
  55.     from within MacWAIS.)
  56. *    Added ISO-1 translation for characters > 128.  (The translation information
  57.     is contained in Resource 'cmap', id = 128.)
  58. *    Modified ProgressD so BytesPerSec value is updated either every time
  59.     additional bytes are received or every second -- whichever occurs first.
  60. *    Modified mwdRetrieve so cursor is made visible before search is initiated.
  61.  
  62. Changes from 1.26:
  63. *    Fixed a bug in init_for_source.  It was parsing the port string with atoi
  64.     -- which yields a 2-byte number.  This restricts port numbers to a maximum of
  65.     32767.  I've changed atoi to atol.
  66. *    Added ConfirmMessage function AMUtils.
  67. *    Added file-not-found (fnfErr; -43) error handling to DoViewOther.  It now
  68.     asks the user if s/he wants to manually launch a viewing application.
  69. *    Renamed PathNameFromDirID and PathNameFromWD to DirIDToPath and WDToPath
  70.     (for consistency).  Reordered args to DirIDToWD, too.
  71. *    Modified myNCSASocketAbort so it processes events during SP_MISC (which is
  72.     called during sock_tcp_connect).  This allows processing to be aborted during
  73.     socket connects.
  74. *    Fixed bug in VScrollToBar so it properly scrolls in the presence of an
  75.     updateRgn.  Also fixed VFind so it updates an existing updateRgn properly, too.
  76. *    Modified DoClear, DoCut, and DoPaste so they mark Question Windows as
  77.     having been modified.
  78. *    Fixed bug in FilterViewSourceD.  (It was swallowing <Return> and <Enter>
  79.     key presses without processing them.)
  80.  
  81. Changes from 1.25:
  82. *    Fixed bug in suGetDirectoryPath which incorrectly updated a freshly saved
  83.     Source's vRefNum.
  84. *    Modified AddLauncher so "Choose Example…" now filters out applications.  (A
  85.     *common* user error.)
  86. *    Added EditLaunchers LDEF.  Disabled launchers are now grayed-out (instead
  87.     of the hokey '+'/'-' stuff).
  88. *    Added additional "View Catalog As:" Preference that queries the user for
  89.     the viewing style (i.e., either as text or as a document list).  This new
  90.     Preference is now the default.
  91. *    Modified myTextFilter (used as a dumptextHook) so it doesn't remove tabs.
  92. *    Fixed bug in VScrollToBar so it doesn't attempt to copy screen bits when
  93.     there's an existing updateRgn.
  94.  
  95.  
  96.  
  97. MacWAIS 1.25 Release Note 27Sep93
  98. ---------------------------------
  99. MacWAIS 1.25 includes one important new capability; namely, a Preference that
  100. specifies where temporary files are stored.  (Before, this was the folder
  101. from which MacWAIS was started.)  The obvious application is locating MacWAIS
  102. on a read-only volume.  (This new feature was "encouraged" by
  103. Pascal.DEGIOVANNI@enslapp.ens-lyon.fr :-).
  104.  
  105. As before, updates to the MSWord version of the User Manual have been designated by
  106. change bars in the right-hand margin.  Thanks to Patrick Hoepfner (hoepfner@heasfs.gsfc.nasa.gov) the size of the User Manual has shrunk dramatically (e.g., ~550k).  The reason?  MSWord's "Fast Save" option (which, heretofore, I was using).  It simply appends changes to the end of the file!
  107.  
  108. Changes from 1.24:
  109. *    Added a Temp File Folder Preference allowing MacWAIS to be stored on a read-only
  110.     volume.
  111. *    Fixed bug in Select Sources and Edit Source dialogs that prevented the initial
  112.     filesystem folder from being correct (it would wrongly select the Desktop).
  113. *    The names of retrieved Sources now have trailing filesystem paths removed.
  114. *    Modified Prefs file creation so it has the correct type and creator.
  115. *    Modified local file retrieval so it can handle files > 32K.
  116.  
  117.  
  118. MacWAIS 1.24 Release Notes 07Sep93
  119. ----------------------------------
  120. MacWAIS 1.24 includes two important new capabilities.  First, it is no longer dependent
  121. on Color QuickDraw (which it was *only* by oversight) so it now runs on "Classic"
  122. QuickDraw Systems (i.e., PB100, SE, etc.).  Second, it now can search Local sources (i.e., indexes that reside locally).  (The documentation doesn't reflect the local search capability (sorry, Ann!) -- I'm going to change the Source interface to incorporate this new capability.  When I do, the documentation will change.)  And, as a plug, I'm working on porting the indexer to the Macintosh.  I've got the basic port done (and it works!), I'm now working on the UI.  More details at a later date.
  123.  
  124. Updates to the MSWord version of the User Manual are designated by change bars in the
  125. right-hand margin.
  126.  
  127. MacWAIS 1.24 is roughly 90K *bigger* than 1.23.  It grew because I migrated to the
  128. new ThinkC 6.0 development environment, and there are bugs with "smart" linking; so,
  129. I turned that option off (which results in a larger executable).
  130.  
  131. Changes from 1.23:
  132. *    New, underlying socket library.  This, plus some other modifications, have increased
  133.         download capability by ~2x.
  134. *    Removes Color QuickDraw dependencies.  MacWAIS now runs on Classic QuickDraw
  135.         Systems (PB100, SE, etc.).  (Reported by Sami.Tikka@hut.fi, Kent Kalnasy
  136.         (kkalnasy@bvu-lads.loral.com), and Jonathan Brecher (brecher@mac.archive.umich.edu).
  137.         Thanks for the reports -- sorry for the incompability!)
  138. *    Allows searching of Local sources.  (Note:  Local sources can ONLY be specified by
  139.         manually editing the Source description.  The host":ip-name" line should be removed,
  140.         and the ":database-name" should be the Macintosh pathname to the index file.  This
  141.         will ultimately become specifiable directly in MacWAIS.)
  142. *    In the Select Sources dialog, Selected Sources may be deselected by first highlighting
  143.         them and then pressing Delete.  (The documentation has been updated to reflect this
  144.         addition.)  (Suggested by Harry Morris (morris@wais.com).)
  145. *    Miscellaneous shortcuts added to dialogs (e.g., cmd-D means "Don't Save").
  146.  
  147. How do I install it?
  148. ------------------
  149. MacWAIS and the wais-sources folder may be located anywhere on your hard disk.  Once MacTCP is installed, MacWAIS is ready to go!
  150.  
  151. What do I do if I have questions and/or problems?
  152. ---------------------------------------------
  153. Send email regarding questions, problems, or suggested enhancements to mac-shareware@einet.net.
  154.  
  155. Acknowledgments
  156. ----------------
  157. Special thanks go to the following people and organizations for their help in the development of MacWAIS:  the Electronic Power Research Institute (EPRI), Gerry Brown, Jim Matthews, Rodney Robertson, Paul Rutz, and Archie Warnock.